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INTRODUCTION 

This memo describes the practical Implementation of 
program* written In the language EUTERPE. Details of this 
language are given In the author's thesis ("A Parallel 
Processing Model of Musical Structures") and will not be treated 
here. He shall only be concerned with the preparation and 
processing of a EUTERPE source program. Sample programs are 
given In their entirety In the thesis or may be read off the 
author's file directory (SWSj). Notatlonal conventions are 
those of Dowson's guide to the A. I. Lab timesharing system (A. 
I. Memo No. 215). 

The EUTERPE system consists, essentially. In five stages 
of operation. These are. In summary, as follows: 

1) Preparation of a source file. This Is basically the 
"EUTERPE program," I.e. the representation of a piece of music 
In the EUTERPE language. 

2) Assembly. In order to be run, a EUTERPE program must 
be assembled Into a binary file which Is actually loaded Into 
the computer. 
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3) Debugging. A EUTERPE binary Is normally loaded Into 
che PDP-G; and as It Is running, this computer plays the music 
represented by this program. The execution of the program 
Involves a real-time Interpretation of EUTERPE's six voice 
programs which Is monitored by DDT, a debugging facility. (This 
DDT Is not to be confused with the DDT which monitors the ITS 
timesharing system; It Is a special DDT which runs only In the 
PDP-6.) This DDT has facilities to aid the debugging of EUTERPE 
programs. 

i*) Compiling. Because this binary file runs 

Interpreted, the sound which Is produced has certain distortions 
due to the timing of the Intepreter. These may be overcome by 
preparing a compiled version once the program Is debugged. 

5) Playing complied music. The PDP-6 Is again the 
"Instrument;" however, the monitor for this player runs In the 
timesharing system. It Is also compatible with the music 
complied by Peter Samson's MU5C0H (A. I. Memo No. 107). 
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PREPARATION OF A SOURCE FILE 

A EUTERPE source program should be written as a TECO 
file which will Chen be assembled by MIDAS. In order for the 
program to be properly processed It Is necessary to assemble the 
Interpreter for EUTERPE Instructions along with the source 
program. This Is achieved by beginning the source file with 

the command: 

. INSRT EUTERP;EUTERP > 

This will supply the latest working version of EUTERPE, (Recent 
not-necessarl ly-worklng versions wl 1 1 have user name SW5, ) 
Programs for the six voices may be Inserted following this 
command. Since a program for voice n Is to begin at address 
VOICEn, this program should be preceded by the MIDAS pseudo- 
operation LOC VOICEn. For example, here Is the beginning of a 
EUTERPE program: 

TITLE MODULIERENDER ZIRKELCANON 

.INSRT EUTERP;EUTERP > 

LOC V0ICE1 ;CAHTUS FIRMUS 

WAVE ALL, SQUARE ;ALL VOICES SOUNO SQUARE WAVES 
MOVEI 1,6 ACCUMULATOR COUNTS SIX REPETITIONS 

KCtD ;NOTE WORDS FOR CANTUS FIRMUS 

K D IT 
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Finally, the file should end with the command! 



END TUNE 
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ASSEMBLY 

Tht actual assembly of a EUTERPE source file Is 
accomplished by MIDAS In the same manner as the assembly of an 
ordinary assembl y-language file. Persons unfamiliar with MIDAS 
may easily assemble their programs by typing the following 
commands from DDT: 

MIDAStlcLK 

f I lenamel_f I lename2cr 

This will create a binary file called fllenamel BIN which may 
either be run Interpreted on the PDP-G or run In ITS to produce 
a compl led file. 

MIDAS error messages are listed In Peter Samson's MIDAS 
memo (A. I. Memo No. 90); however, there Is one error for 
which no message Is given. If a EUT£RPE program Is too long, 
there may not be enough room for It In the PDP-6. When MIDAS Is 
completed. It gives the addresses of the core assigned to 
generated constants* If this area extends higher than 30000, 
there Is a danger that It will conflict with DDT; and the 
program should be broken Into smaller segments. 
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DEBUGGING 

The Interpreted execution of a EUTERPE binary plays 
music using two 9-blt d-to-a converters. It Is loaded Into the 
PDP-6, along with a DDT, by TENLOD. By way of example, the 
EUTERPE binary file fllenamel BIN would be loaded by typing the 
following to the timesharing DDT: 

TENLOD^ULlK 

L f I lenamel_BINcr 

F 

The last command actually starts the DDT In the PDP-6 
running, TENLOD may type out one of two critical error 
messages. "PDP-10 NOT AVAILABLE 11 means that some other user 

has the PDP-6. "RUNNING?" may be typed In response to the F 
command. This may or may not mean the PDP-6 Is not running. 
Check the RUN light on the PDP-C control panel (below the 
mlcrotape drives; It Is labeled RUN). If It Is on, TENLOD Is 
probably confused. If It Is off, depress the INSTRUCTION STOP 
switch (and restore to center position) on the PDP-6 control 
panel; and do the same for the 10 RESET switch. Set the 
address switches to 3fc000, and depress the START switch. DDT 
should now be running In the PDP-6, 
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The best way to communicate with the DDT In the PDP-6 Is 
to use Ti#, the teletype at the PDP-G console. On the left side 
of the 340 display Is a toggle switch In the up position. 
Depressing this switch causes this teletype to communicate 
directly with the PDP-6/ rather than with ITS. When this switch 
Is In the down posltllon, the user Is ready to type commands at 
the DDT In the PDP-6. 

Unfortunately, there Is no available documentation for 
the PDP-6 DDT. The novice would do well to consult the section 
on DDT In DEC's PQP1Q RefgrCMCQ HflndbPpK; most of the basic 
debugging facilities mentioned therein are Identical to those of 
PDP-6 DDT. Also, Tom Knight's A. I. Memo No. 147 lists most of 
the DDT Instructions but al so Includes commands for the 
timesharing monitor. (N.B. For purposes of using PDP-6 DDT, A. 
I. Memo No. 1<#7 Is far preferable to Its revision, A. I. Memo 
No. 1WA; get It before It disappears.) 

Before running a EUTERPE program, the amplifier and data 
switches have to be set for monitoring the d-to-a converters. 
Turn the amplifier on and set It to channel AUX2 with relatively 
high volume. It Is desirable to lower the treble and boost the 
bass because of the rather nasty sound which these d-to-a 1 * 
currently make. Finally, the address switches should be set to 
20. 
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To start the EUTERPE program playing, type TUNE@G; the 
program will now play to Its completion, after which control 
will be returned to DOT. On subsequent occas ions, the pi aye r 
may be started by typing SETUPf$)G. The player may be stopped by 
typing a space, 

EUTERPE has eight breakpoints which cause a temporary 
Interruption of the program. To enable these breakpoints, type 
EUBRK(AA) (7) B. To assign an address to a breakpoint, type 
BREAKS+n/, where n ranges from to 7* Then type the address 
which Is to be the location of the break. When anv voice 
program encounters that address, the playing will stop; and 
control will return to DOT, which will type out the address of 
the break. To resume playing from that breakpoint, type(|)P. 

Some bugs are more fatal than others. Some, for 
example, may prevent returning control to DDT* DDT may be 
restarted from the POP-6 console by hitting INSTRUCTION STOP, 10 
RESET, setting the address switches to 3**000, and hitting START. 
(Don't forget that the address switches must be set to 20 for 
listening to music.) If this succeeds, the teletype will respond 
with a reassuring carriage return and line feed. If It falls, 
DDT has been clobbered and It Is necessary to reload the PDP-6. 
Flip the teletype toggle switch up again, and type £l£lX. This 
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restores TENLOD's attention, and you can proceed exactly as If 
you had typed TENL00£££]_K. (Short cut: If you just type L cr, 
TENLOO will load the same file It loaded on the last L command.) 

If you do not have access to T-, the situation Is not 
hopeless, although It Is much more painful. You will have to be 
In the vicinity of the PDP-6, not only so that you may hear the 
loudspeakers, but also to be able to readily access the PDP-6 
console. From TENLOD first type 10 (this Is the letftqr 0); 

TENLOD will respond with a carriage return and line feed, after 
which you type an L command as above. Then type PF Instead of 
F, and your teletype Is now communicating with the DDT running 
In the PDP-6. Things may now proceed exactly as above, except 
that hitting a space will not Interrupt the PDP-6 playing music. 
To do this, you have to stop the computer from Its console and 
restart at 3^0 00 (fol lowing the same procedure given above In 
case the program hangs up). To get back to TENLOD, type fitrl X: 
and to return to the PDP-6 DDT from TENLOD, type PS, 

Once you have become accustomed to debugging EUTERPE 
programs, you will probably have occasions when you will not 
have to actually hear the program to debug It. In such a case, 
the program does not have to be run on the PDP-6 but can be run 
as a Job on the timesharing system. Suppose you have such a 
program assembled wl th file name f II enamel BIN. From 
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(timesharing) DDT, create a Job by typing: 



jobnamef?) J 



Next, load the file by typing: 

01 f IIenamel_BINcr 

The program may now be started by typing N0SIX(pG, and It will 
type out .VALUE when It stops. On subsequent occasions. It 
may be started by typing SETUP^) G. 

It Is also possible to play a EUTERPE program through 
the Mlnsky music box hooked Into a terminal which outputs 30 
healthy characters per second. (Noise In either the terminal or 
the line may cause dlsasterous lossage.) This output rate will, 
unfortunately, distort most rhythmic subtleties; but It will 
provide a rough approximation for debugging purposes. To run a 
program In this manner, create a job and load the file, as 
above, and start the program by typing B0X{$)g. The appropriate 
control characters are transmitted for turning the box on and 
off and silencing and restoring typeout; and these control 
signals alow for breakpoints In the EUTERPE program. Any other 
Interrput Ions, however, may lose In any number of ways. In this 
cose, the user may have to supply control chaacters from the 
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terminal : 



lower-case 8 
lower-case a 
lower-case b 



box and typeout on 
box on, typeout off 
box off, typeout on 
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COMPILING 

Once one has a debugged version of the program, one may 
compile a much more euphonic performance. This Is done In 
HACTRN (rather than In the PDP-6) by creating a Job In ITS, 
loading the binary of this debugged version, and starting at the 
address COMPIL (I.e. typing COMPH@G). The program will echo 
with an asterisk, whereupon the user prescribes condl t Ions for 
output -- device name, user name, file names. These have the 
fol lowing defaul t values: DSK:user name; MUSI C f 1 1 enamel . 

While It Is not recomended practice. It Is possible to 
take a debuged EUTERPE program directly from the core of the 
POP-6 and compile It. Starting In PDP-G DDT, return to TENLOD, 
type £i£l2* and then type PDP6@J. Type 55776/ followed by a 
ctrl Y. Dump out this core Image using® Y. Now proceed as 
above, loading In this dumped file Instead of an assembled 
binary. (Any file which Is already loaded In the timesharing 
system, e.g. programs using the MInsky box for debugging, may 
also be started at COMPIL and need to be dumped only If the user 
wishes to save them.) 
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PLAYING 

Compiled music Is played by APOLLO which Is loaded by 
typing APOlLO£i£lK. when It Is loaded, APOLLO echoes an 
asterisk unless the PDP-6 Is not available. In which case It 
flushes I tsel f . APOLLO commands are analogous to those for 
MUSRUN and are as follows: 

L Is the command for Loading files. When It Is typed, 
APOLLO echoes with a space, after which the user may type a file 
name. If the file Is not found, APOLLO replies with a question 
mark. Default values are Initially DSK: EUTERP;MU5IC OUTPUT, 

but once a file has been loaded, I ts specif lea t Ion determines 
default values. However, If only one file name Is given. It Is 
taken as the second; and the first Is assumed to be MUSIC. 
APOLLO will not only load files compiled by EUTERPE, but also 
those complied by MUSCOM which were originally Intended to be 
loaded by MUSRUN. If the file Is completely foreign to APOLLO, 
It will type "CAN'T FIND DATA" followed by another asterisk. If 
the PDP-6 Is not running, APOLLO will type a message to that 
effect. If this Is the case, hit INSTRUCTION STOP followed by 

10 RESET, set the address switches to 100, and hit START. 

If a compiled file Is too large to fit In the PDP-6 
core, APOLLO will load as much as possible and then type "MORE." 
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To continue after the loaded portion is played, type A. If there 
Is still too much for one load, another MORE message will be 
given, and so on until all of the file has been digested. 

P Is the Play command. When it Is typed, the PDP-6 
starts playing. For this player, the address switches and data 
switches should be set to zero and the amplifier should be set 
to channel AUX1 . 

S Is the Stop command. Typing It will cause the PDP-6 
to stop playing. 

Q Is the Quit command. Typing It will flush APOLLO. 

T Is the Tempo command. When It Is typed, APOLLO echoes 
with an equals sign and the tempo constant. If It Is preceded 
by a number, then the tempo constant Is set to that number. (Do 
not type a space between the number and the T.) Files compiled 
by EUTERPE have the tempo constant kik. 

D Is the Detune command* It Is preceded by a six digit 
octal number which sets the detuning constants for the six 
voices (see A, l t Memo Up, 107), 
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? cause 5 APOLLO to list these commands . 

The APOLLO player may also be run from the PDP-G dat; 
switches In the manner described In A. I. Memo No. 107, 



